home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u289.dms / in.adf / Kpri / Kpri.doc < prev    next >
Encoding:
Text File  |  1992-07-26  |  6.4 KB  |  189 lines
  1.  
  2.                                 Kpri  2.0
  3.                               © Koessi 91
  4.  
  5.                   /*  It's public domain - have fun ! */
  6.  
  7.    NAME:
  8.       Kpri
  9.  
  10.    USAGE:
  11.       In CLI/Shell:
  12.         type
  13.                'Kpri <filename>'
  14.  
  15.         You may add a textfile as argument on the commandline. This
  16.         will be processed to use 96 chars per line, 88 lines per page,
  17.         no splitting, but titlelines (default).
  18.  
  19.       On WorkBench:
  20.         DoubleClick on it's icon to start it. You may add a textfile
  21.         as argument by shift-DoubleClick on its icon together with the
  22.         Kpri-icon. This will be processed to use 96 chars per line, 88
  23.         lines per page, no splitting, but titlelines (default).
  24.  
  25.    VERSION:
  26.       1.01 september 91   /*  needed REQ.library, but is still
  27.                               compatible with OS 1.3 & 2.0 ! */
  28.       2.0  october   91   /*  now needs (only...) OS 2.0 !!! */
  29.  
  30.       Kickstart 37.145 / Workbench 37.33 / A3000 tested.
  31.  
  32.    FUNCTION:
  33.       Another nec-p6 intuition-frontend to choose several printstyles.
  34.       The special gag:
  35.       You can split your text files into their odd and even pages and
  36.       print on both sides of the paper, which doesn't only save paper
  37.       - it also makes long documents better readable (to me).
  38.  
  39.       When started a window should appear in the mid of the wb-screen.
  40.       Several gadgets allow control over the programs features:
  41.  
  42.  
  43.  
  44.       "lines per page"    /*  CYCLEKIND, default 88 */
  45.  
  46.                     chooz one of two pagelengths:
  47.  
  48.                      66 or 88 are possible
  49.  
  50.                     This gadget also reflects the style ordered with
  51.                     a text selected from storagelist.
  52.  
  53.  
  54.       "chars per page"    /*  CYCLEKIND, default 96 */
  55.  
  56.                     chooz one of three linelengths:
  57.  
  58.                      80 chars per line    /*  use this for school */
  59.                      96 chars per line    /*  extra fast mode on nec-p6 */
  60.                     132 chars per line    /*  good for listings */
  61.  
  62.                     This gadget also reflects the style ordered with
  63.                     a text selected from storagelist.
  64.  
  65.  
  66.       "split"             /*  CHECKBOX, default off */
  67.  
  68.                     split the file into it's odd and even pages.
  69.  
  70.  
  71.       "add titlelines"    /*  CHECKBOX, default on  */
  72.  
  73.                     adds title-line on top of each page , showing
  74.                     date of printout, filename and page-number.
  75.  
  76.  
  77.       "automatic"         /*  CHECKBOX, default on  */
  78.  
  79.                     This will prompt you for printing all the stored
  80.                     texts in the following order:
  81.  
  82.                     1.  All odd  pages of splitted texts
  83.  
  84.                     /*  turn your paper at this point to use the other  */
  85.                     /*  side!!! */
  86.  
  87.                     2.  All even pages of splitted texts
  88.                     3.  All unsplitted texts
  89.  
  90.                     If the storagelist is empty and "automatic" is ordered
  91.                     every call of the filerequester will prompt you whether
  92.                     to print the pages immediately or skip them for later
  93.                     use. Also you will be asked to print all the stored
  94.                     texts when terminating the program.
  95.  
  96.  
  97.       "load files"        /*  BOOLEAN */
  98.  
  99.                     calls the asl-filerequester to load a text into memory,
  100.                     that will be processed depending on the page- and
  101.                     linelength chosen, doing split and titling as ordered.
  102.                     You can use different styles for different files !
  103.  
  104.  
  105.       "storage:"          /*  LISTVIEW  */
  106.  
  107.                     The processed texts are stored in memory and listed
  108.                     in a scrollfield, from where you can choose them at
  109.                     anytime to print them out or erase them from memory
  110.                     if anything is wrong ???.
  111.  
  112.  
  113.       "print it"          /*  BOOLEAN */
  114.  
  115.                     Print out textbuffer chosen from storagelist.
  116.  
  117.  
  118.       "forget it"         /*  BOOLEAN */
  119.  
  120.                     Erase textbuffer chosen from storagelist.
  121.  
  122.  
  123.       "Q U I T"           /*  BOOLEAN */
  124.  
  125.                     Can't use my supertool?   /*  love it or leave it  */
  126.  
  127.  
  128.    BUGS:
  129.       None known yet.     /*  \8- */
  130.  
  131.  
  132.    TODO:
  133.       Get out bugs
  134.       Add something
  135.       Earn money
  136.  
  137.  
  138.    COMPILING:
  139.       Compiled by DICE - Matt Dillon's C-compiler-enviroment.
  140.                                         /*  I do have fun - thanx Matt  */
  141.  
  142.       I used OS 2.0 includes & amiga20.lib - a lot of special 2.0-stuff.
  143.       Libraries are opened automatically by DICE-startup!
  144.  
  145.       Sourcefiles:
  146.  
  147.         defs.h      - included in all #?.c files
  148.         protos.h    - generated by 'makeproto'
  149.         gadgets.c   - generated by 'tpledit' and modified to my needs
  150.         main.c      - checks for OS 2.0, opens window and does idcmp-loop
  151.         parse.c     - actions according to the gadgets
  152.         process.c   - buffer handling, read, split and titling of texts
  153.         prtinits.c  - printer and parallel device initializings
  154.         subs.c      - memory and environment routines
  155.         pic.c       - logo image datas
  156.         tags        - nice when using 'dme'
  157.         flowchart   - generated overview of function calls
  158.  
  159.         dcc_back.o  - (D)link with this to detach anything from cli.
  160.                       Currentdir is set correctly, but no stdin, stdout or
  161.                       stderr supported ! Unusable with resident options or
  162.                       source that declares its own '_main'-function !
  163.                       The resulting program will not work after being
  164.                       crunched by 'PowerPacker' or 'Imploder'
  165.                       /*  great programs, by the way!  */
  166.  
  167.         wbmain.o    - (D)link with this to support simple workbench-startup.
  168.                       Complete filenames of multiselected Icons are send as
  169.                       arguments to 'main(int argc, UBYTE **argv)' as if
  170.                       they were given on a cli-commandline. No tooltype
  171.                       support yet! Workbench-Message is replied automatically,
  172.                       so your source will not notice any difference from the
  173.                       cli-starts!
  174.  
  175.  
  176.    SEE ALSO:
  177.       DmakeFile
  178.  
  179.  
  180.    CREDITS:
  181.       Thanx to Matt Dillon for 'DME', 'tpledit' & 'DICE'  /*  DO REGISTER!!! */
  182.       Thanx to Fred Fish and all the authors for the Library.
  183.  
  184.  
  185.    AUTHOR:
  186.       Koessi
  187.       phone germany 02192 7630
  188.  
  189.